home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Internet Toolkit
/
Internet Toolkit.iso
/
tutorial
/
pc_learn
/
buildut.tut
< prev
next >
Wrap
Text File
|
1993-08-16
|
28KB
|
670 lines
The following information is reprinted with permission, Ultimate
Power Tips 1.0A (c) 1992, 1993 Paul Scanlon, Scanlon Enterprises
----------------------------------------------------------------
BUILD YOUR OWN UTILITIES
----------------------------------------------------------------
This is a section devoted to users who want the most from their
system and want to learn about using the DOS debug program to
create small, powerful utilities. Using debug and special debug
scripts which are frequently found in computer magazines you can
create your own software programs. You don't have to be a "power
user" to use these utilities. Everything you need to create the
utilities comes with DOS.
You'll need :
1) DOS DEBUG.EXE (or DEBUG.COM)
2) DOS EDLIN.COM (or any good text editor)
3) Some free disk space
The DOS DEBUG program, is very well known in Power User Circles,
and amongst programmers. Now, it is time, for everyone else to
learn the potential of this FREE program, that is included with
Microsoft DOS.
DEBUG is a tool designed for aiding the programmer in debugging
software. Because Microsoft designed more into it, it is often
used as a compiler! Yes, you can write a program in assembly
language, and compile it, without even going out and buying a
compiler. Actually, since we are talking about assembly
language, this technique is called Assembling, instead of
compiling. After making your first utility, from this section,
you may call yourself a programmer! Not only that, you can say,
that you've programmed in Assembly Language, the hardest of all
programming languages!
The purpose of this section, is NOT to provide you with detailed
workings of DEBUG, as powerful as it may be, but to provide you
with enough knowledge to create the utilities.
To create these utilities, you'll be using a command line (DOS
prompt) similar to the following :
DEBUG < filename
Where, 'filename' is the name of the file we tell you to create
using a text editor (or EDLIN). The redirector symbol < is used,
because we are going to pretend we are entering the keystrokes
found in the file 'filename'. Actually, we have, but, we have
done so, in advance. The redirector tells DOS, to get keyboard
input from the file 'filename', instead of the actual keyboard.
Here's a tip: you can use your word processor to "cut and
extract" the debug scripts presented below from this larger PC-
Learn tutorial file (BUILDUT.TUT) into a smaller standard ASCII
text file also called a script file. Be sure to move all text
lines of the script file flush left (to the far left of the
screen) and use only the script data as presented. Save the new
file which will become your debug script file. To cut or clip
the script from the larger PC-Learn tutorial you will usually
use the "mark block" and "cut block" capability of your word
processor to "clip" it from the main PC-Learn tutorial and save
it into a smaller file.
Let us begin, now, with our first program!
Get Available Memory Quickly
Name this script file (that's what we call a file we use to
execute DEBUG automatically), FM.SCR (for FreeMemory).
You can either type it in manually to a ASCII text file using
your word processor or use the tip above.
Name of file you will create: FM.SCR
N FM.COM
E 100 EB 09 90 4B 20
E 105 46 72 65 65 24
E 10A 0A 2E A1 02 00
E 10F 8C CB 2B C3 B1
E 114 06 D3 E8 B9 01
E 119 00 F6 36 0A 01
E 11E 50 0A C0 74 05
E 123 32 E4 41 EB F2
E 128 58 8A D4 80 C2
E 12D 30 B4 02 CD 21
E 132 E2 F4 B4 09 BA
E 137 03 01 CD 21 C3
RCX
3C
W
Q
If you copied this correctly, you will have created your first
DEBUG script file. You may be wondering what all those
alphabetic characters are doing mixed in with the numbers (if
you are a programmer or power user, you already know). We are
using what is referred to as HEX numbers, which is a numbering
system based upon 16, rather that our usual base 10 (digits 0-
9). For the program to work, a complete understanding, is NOT
necessary.
This little script, will create a program, FM.COM, which, when
executed, will display the amount of available memory. By
creating this program, you will no longer have to execute the
DOS program CHKDSK to get the memory available. For those of you
with newer DOS 5.0, you have the DOS program MEM which reports
this value. However, the DOS MEM program is NOT 60 bytes long!
Yes, we did say 60 bytes. The DOS MEM program is almost 40K
bytes! Throw out that disk hog, and use FM which is smaller.
Well, we have the script in a small text file, but, how do we
make the program? Easy, just enter the following line :
DEBUG<FM.SCR
When executed, as above, your display should have the following
lines displayed.
CXC000003 01 CD 21 C3
Writing 0003C bytes
-Q
If your screen differs from the above, recheck the script file,
you created, with the earlier text (above) in this tutorial.
Debug will create the new file FM.COM which is the actual
utility program. To run it just type FM.
Now, when you want to know the amount of available ram, you
simply enter "FM" and press <ENTER> at any DOS prompt. For those
of you who do have DOS 5.0 and the program MEM, and have noticed
a discrepancy in available size reporting, remember, MEM is
reporting BYTES FREE, and FM is reporting K (thousands) of bytes
free! To verify that FM is indeed reporting accurately, simply
divide the reported amount by MEM, by 1024, to get K bytes as
reported by FM. You'll see, these numbers are the same!
Num Lock Off
If you are using one of those 84 key (old time keyboards), or
simply prefer to use cursor positioning from the numeric keypad,
and want to make sure that your NumLock is Off at boot time,
create the following DEBUG script file. We will name the script
file "NN.SCR" for no num lock, which will make the program
"NN.COM".
NN.SCR
A 100
MOV AX,0
MOV DS,AX
AND BYTE PTR[417],DF
INT 20
{empty line}
RCX
C
N NN.COM
W
Q
Be sure to leave the line with "{empty line}", blank. Just press
the <ENTER> key for that line. We use "NN", as the name, for No
Num Lock.
Now, from a DOS prompt, type : DEBUG<NN.SCR
You should see the following display after typing the above.
CXC00000C INT 20TEXPTR[417],DF
WritingO0000C bytes
-Q
If your screen differs from the above, recheck the script file,
you created, with the earlier text (above) in this tutorial.
Now, all you have to do is enter NN <ENTER> at a DOS prompt to
set num lock off. The best use, is to put NN on a line of your
AUTOEXEC.BAT file, and have AUTOEXEC automatically set num lock
off at boot time.
Whoa! Notice the difference between this script and our earlier
one? The first example, was using hex input, and here, we use,
what is called assembly language. The difference between these
two approaches, is invisible to you, the user. This tutorial,
will intermix the two types of script files, Hex and Assembly,
so you will become familiar with them. In this way, you'll be
able to quickly enter them, from a magazine article. Computer
magazines frequently have lots of practical debug script files
you can try!
Lets take a moment, to cover two DEBUG script lines, the "RCX"
and "N". The line containing "RCX" tells DEBUG, that we wish to
set the number of bytes, for a file size, in this case, "C",
next line, which is 12 decimal. Thus, we will have created a COM
file (NN.COM), which is only 12 bytes long!
Faster Repeat Keys
This script file, will create a program to speed up repeat keys.
Repeat keys, are keys which can be held down, and automatically
duplicate characters. IE...Hold down the letter "k", soon, the
screen will start filling up with "k". Now release the "k" key,
and "k"'s stop appearing. The speed at which the k's appear, is
called the repeat rate, which is what this program will speed
up. We will call this script file FK.SCR, and it will make a
program called FK.COM (for Fast Keys).
FK.SCR
A 100
MOV AX,305
MOV BX,3
INT 16
INT 20
{blank line}
RCX
A
N FK.COM
W
Q
Now, type : DEBUG<FK.SCR
If your script file is right, you'll see the following displayed
CXC00000A INT 20,305
WritingO0000A bytes
-Q
If your screen differs, then you have entered the script file
incorrectly. If everything goes right, you can now enter FK and
press <ENTER> at any DOS prompt, to speed up your key board
repeat keys. However, to automatically, have this performed at
boot time would be better. To do this, just place a line, with
FK into your AUTOEXEC.BAT file, and from then on, each time you
boot, you'll have the repeat keys speeded up.
Lost Cursor Recovery
If you, like me, have had your cursor become invisible after
executing some program, would like some way to get it back, then
enter this script. This script will create a program, that not
only recovers the cursor, but will restore a screen from
graphics mode, which some games leave it in.
The following script is named RC.SCR, for Recover Cursor, and
creates a program called "RC.COM".
RC.SCR
A 100
MOV AX,3
INT 10
INT 20
{Blank line}
RCX
7
N RC.COM
W
Q
This creates the smallest program yet, only 7 bytes! Now, to
use, simply enter RC and press <ENTER> from a DOS prompt. No
need to have this as part of your AUTOEXEC, unless your AUTOEXEC
starts something which leaves the screen in graphics mode. To
get the best use of this utility, we suggest creating a batch
file to start your game or application which leaves the screen
in graphics mode, or makes the cursor invisible. If your program
is named "GO.EXE" then your batch file would look like this.
GO
RC
Just a simple two line batch file!
For those of you familiar with programming, you'll notice, the
code set attempts to reset the mode to MODE 3, which is 80
column by 25 line color mode. We haven't made an error, do NOT
change anything. If you have a monochrome system, this will
reset that back to monochrome mode! Go ahead and try it.
Comparing The Size of Two Files
Have you ever needed to compare the size of two different files?
This script file will create a program which will do just that.
The program, once created, will display the size difference
between two files. Create the script file FD.SCR (for File
Difference), which then can be used, with DEBUG to create
FD.COM.
FD.SCR
N FD.COM
E 100 EB 5F 90 00 00 00 00 00
E 108 00 00 00 53 79 6E 74 61
E 110 78 3A 20 46 44 20 66 69
E 118 6C 65 31 20 66 69 6C 65
E 120 32 0D 0A 24 00 00 00 00
E 128 00 00 46 69 6C 65 20 4E
E 130 4F 54 20 66 6F 75 6E 64
E 138 20 6F 72 20 46 69 6C 65
E 140 20 4F 70 65 6E 20 45 72
E 148 72 6F 72 0D 0A 24 44 69
E 150 66 20 3A 20 24 24 20 42
E 158 79 74 65 73 0D 0A 24 00
E 160 00 FC BE 81 00 E8 AC 00
E 168 73 0C B4 09 BA 0B 01 CD
E 170 21 B8 02 4C CD 21 89 36
E 178 03 01 FF 0E 03 01 E8 86
E 180 00 72 E7 C6 44 FF 00 E8
E 188 8A 00 72 DE 89 36 05 01
E 190 FF 0E 05 01 E8 70 00 73
E 198 06 80 7C FF 0D 75 CB C6
E 1A0 44 FF 00 8B 16 03 01 E8
E 1A8 77 00 73 07 B4 09 BA 2A
E 1B0 01 EB BC A3 07 01 89 16
E 1B8 09 01 8B 16 05 01 E8 60
E 1C0 00 72 E9 8B 1E 07 01 8B
E 1C8 0E 09 01 3B CA 77 0E 72
E 1D0 04 3B D8 73 08 93 86 CA
E 1D8 C6 06 54 01 2D 2B D8 1B
E 1E0 CA 53 51 B4 09 BA 4E 01
E 1E8 CD 21 E8 4D 00 B4 09 BA
E 1F0 56 01 CD 21 59 5B B8 00
E 1F8 4C 0B DB 75 06 0B C9 75
E 200 02 CD 21 B0 01 CD 21 AC
E 208 3C 20 74 06 3C 0D 75 F7
E 210 F9 C3 F8 C3 AC 3C 20 74
E 218 FB 3C 0D 75 02 F9 C3 F8
E 220 C3 B8 00 3D CD 21 72 11
E 228 8B D8 B8 02 42 2B C9 2B
E 230 D2 CD 21 50 B4 3E CD 21
E 238 58 C3 8B D1 8B C3 FF 06
E 240 5F 01 8B DA 2B C9 2B D2
E 248 2B F6 BF 0A 00 E8 18 00
E 250 53 0B C0 75 E9 0B D2 75
E 258 E5 8B 0E 5F 01 5A 80 C2
E 260 30 B4 02 CD 21 E2 F6 C3
E 268 8B E9 B9 20 00 F8 D1 D0
E 270 D1 D3 D1 D5 D1 D2 73 0A
E 278 2B EF 1B D6 F9 E2 EF EB
E 280 0E 90 3B D6 72 06 75 F0
E 288 3B EF 73 EC F8 E2 DF D1
E 290 D0 D1 D3 8B CD 87 D3 87
E 298 CB C3
RCX
19A
W
Q
This DEBUG script file, is fairly lengthy, as script files goes,
so please be careful when entering it. Should you have problems,
we strongly suggest you use a wordprocessor to extract the above
and use the resultant file with DEBUG directly with DEBUG. If
you have entered the above correctly, and execute the command
"DEBUG<FD.SCR" you'll see the following display.
-N FD.COM
-E 100 EB 5F 90 00 00 00 00 00
-E 108 00 00 00 53 79 6E 74 61
-E 110 78 3A 20 46 44 20 66 69
-E 118 6C 65 31 20 66 69 6C 65
-E 120 32 0D 0A 24 00 00 00 00
-E 128 00 00 46 69 6C 65 20 4E
-E 130 4F 54 20 66 6F 75 6E 64
-E 138 20 6F 72 20 46 69 6C 65
-E 140 20 4F 70 65 6E 20 45 72
-E 148 72 6F 72 0D 0A 24 44 69
-E 150 66 20 3A 20 24 24 20 42
-E 158 79 74 65 73 0D 0A 24 00
-E 160 00 FC BE 81 00 E8 AC 00
-E 168 73 0C B4 09 BA 0B 01 CD
-E 170 21 B8 02 4C CD 21 89 36
-E 178 03 01 FF 0E 03 01 E8 86
-E 180 00 72 E7 C6 44 FF 00 E8
-E 188 8A 00 72 DE 89 36 05 01
-E 190 FF 0E 05 01 E8 70 00 73
-E 198 06 80 7C FF 0D 75 CB C6
-E 1A0 44 FF 00 8B 16 03 01 E8
-E 1A8 77 00 73 07 B4 09 BA 2A
-E 1B0 01 EB BC A3 07 01 89 16
-E 1B8 09 01 8B 16 05 01 E8 60
-E 1C0 00 72 E9 8B 1E 07 01 8B
-E 1C8 0E 09 01 3B CA 77 0E 72
-E 1D0 04 3B D8 73 08 93 86 CA
-E 1D8 C6 06 54 01 2D 2B D8 1B
-E 1E0 CA 53 51 B4 09 BA 4E 01
-E 1E8 CD 21 E8 4D 00 B4 09 BA
-E 1F0 56 01 CD 21 59 5B B8 00
-E 1F8 4C 0B DB 75 06 0B C9 75
-E 200 02 CD 21 B0 01 CD 21 AC
-E 208 3C 20 74 06 3C 0D 75 F7
-E 210 F9 C3 F8 C3 AC 3C 20 74
-E 218 FB 3C 0D 75 02 F9 C3 F8
-E 220 C3 B8 00 3D CD 21 72 11
-E 228 8B D8 B8 02 42 2B C9 2B
-E 230 D2 CD 21 50 B4 3E CD 21
-E 238 58 C3 8B D1 8B C3 FF 06
-E 240 5F 01 8B DA 2B C9 2B D2
-E 248 2B F6 BF 0A 00 E8 18 00
-E 250 53 0B C0 75 E9 0B D2 75
-E 258 E5 8B 0E 5F 01 5A 80 C2
-E 260 30 B4 02 CD 21 E2 F6 C3
-E 268 8B E9 B9 20 00 F8 D1 D0
-E 270 D1 D3 D1 D5 D1 D2 73 0A
-E 278 2B EF 1B D6 F9 E2 EF EB
-E 280 0E 90 3B D6 72 06 75 F0
-E 288 3B EF 73 EC F8 E2 DF D1
-E 290 D0 D1 D3 8B CD 87 D3 87
-E 298 CB C3
-RCX
CX 0000
:19A
-W
Writing 0019A bytes
-Q
After executing DEBUG with the script file, you are now ready to
use FD.COM. To use, enter the following command syntax:
FD file1 file2
This will display the file size difference between 'file1' and
'file2'. If 'file1' is larger than 'file2' the difference is
displayed as a positive value. If 'file1' is smaller than
'file2' then the difference is displayed as a negative number.
In addition, the program will set an ERRORLEVEL which can be
tested from a batch file. The ERRORLEVEL will be "0" if the
files are exactly the same size, "1" if the files are not the
same size, and "2" if there is an error, such as file not found
or can't be read.
Combining the DOS Environment, With Keyboard Input
Sometimes, it is important to ask questions in a batch file,
but, DOS doesn't have any batch file keyboard input, except the
almost useless PAUSE command which waits for any key. PAUSE does
nothing with the keystroke! This script file, IN.SCR, will
create IN.COM. In DOS 6.0 a new utility CHOICE offers the same
capbility.
IN.SCR
N IN.COM
E 100 FC B4 0E B3 0F BE 81 00
E 108 AC 3C 20 74 FB 3C 0D 74
E 110 05 CD 10 AC EB F7 33 C9
E 118 BF 80 00 32 E4 CD 16 0A
E 120 C0 74 3D B4 0E 3C 08 74
E 128 42 3C 0D 74 13 3C 03 74
E 130 2A 3C 20 72 E6 83 F9 7F
E 138 74 2A AA 41 CD 10 EB DB
E 140 CD 10 B0 0A CD 10 B4 09
E 148 BA 7B 01 CD 21 B4 02 E3
E 150 0A BE 80 00 AC 86 D0 CD
E 158 21 E2 F9 B8 00 4C CD 21
E 160 0A E4 74 F7 B8 07 0E CD
E 168 10 EB B0 E3 F7 B0 08 CD
E 170 10 B0 20 CD 10 49 4F B0
E 178 08 EB C1 53 45 54 20 41
E 180 53 4B 3D 24 90 90 90 90
RCX
84
W
Q
If you have entered the above correctly, and execute the
following command : DEBUG<IN.SCR you will see the following
screen displayed.
CXC000053 4B 3D 24 90 90 90 90
Writing 00084 bytes
-Q
Now, you are ready to use IN.COM. This program will allow a user
to enter a string of text, such as a name, password, etc... To
use this program, you must use the DOS redirector, to force the
output of IN, to a file. When this is done, you'll end up with a
one line file like this :
SET ASK=input
Where 'input' is what the user entered.
For instance, you want to ask the user their name, you'd create
a batch file with these lines :
IN What is your name ? > NAME.BAT
CALL NAME.BAT
ECHO Why Hello %ASK%!
The first line passes a question to our new program IN.COM,
which sends its output to the file NAME.BAT, via the redirector
">". If the user responds with "Jeff" to the question, then the
batch file "NAME.BAT" will contain "SET ASK=Jeff". The second
line of the batch file, under DOS 3.3 and up, calls the new
batch file just created from the first line. This batch file,
executes the one line, "SET ASK=Jeff", which places "Jeff" into
the environment variable ASK. Now, the final line can display
the result, by embedding the variable name ASK inside "%"
characters. This is how a batch file uses an environment
variable. The variable name will be replaced by the contents of
the variable, "Jeff". Thus our screen would display :
Why Hello Jeff!
And NOT : Why Hello %ASK%!
By using this program, your batch files can add that personal
touch. Other uses, of course, include password input, selecting
a directory name, and almost anything you can think of, which
requires a line of input.
The Forgotten Rename Feature
Older versions of DOS forgot one important function, Directory
Rename. This function is suitable for DOS 3.0 and up. If you
have an earlier DOS, why NOT upgrade NOW! We'll call our final
script file "DR.SCR" for Directory Rename, which will create
"DR.COM" when used with DEBUG.
DR.SCR
N DR.COM
E 100 E9 86 00 00 52 65 71 75
E 108 69 72 65 73 20 44 4F 53
E 110 20 33 2E 30 20 61 6E 64
E 118 20 75 70 0D 0A 24 00 55
E 120 73 61 67 65 20 3A 20 52
E 128 44 20 5B 64 3A 5D 5B 70
E 130 61 74 68 5D 6F 72 67 6E
E 138 61 6D 65 20 6E 65 77 6E
E 140 61 6D 65 0D 0A 24 00 00
E 148 00 00 20 69 73 20 4E 4F
E 150 54 20 61 20 64 69 72 65
E 158 63 74 6F 72 79 0D 0A 24
E 160 00 00 00 44 69 72 65 63
E 168 74 6F 72 79 20 4E 4F 54
E 170 20 66 6F 75 6E 64 20 6F
E 178 72 20 49 4E 56 41 4C 49
E 180 44 20 70 61 74 68 0D 0A
E 188 24 B8 00 30 CD 21 3C 03
E 190 73 0C BA 0E 01 B4 09 CD
E 198 21 B8 01 4C CD 21 BE 81
E 1A0 00 FC E8 5B 00 73 05 BA
E 1A8 1F 01 EB E9 89 F2 4A E8
E 1B0 41 00 72 F3 C6 44 FF 00
E 1B8 89 F3 E8 43 00 72 E8 EE
E 1C0 FE 4F E8 2E 00 73 06 80
E 1C8 7C FF 0D 75 DA C6 44 FF
E 1D0 00 B8 00 43 CD 21 F7 C1
E 1D8 10 00 75 0D C6 47 FF 24
E 1E0 B4 09 CD 21 BA 4A 01 EB
E 1E8 AC B4 56 CD 21 BA 63 01
E 1F0 72 A3 C3 AC 3C 20 74 06
E 1F8 3C 0D 75 F7 F9 C3 F8 C3
E 200 AC 3C 20 74 FB 3C 00 75
E 208 02 F9 C3 F8 C3 90 90 90
RCX
10D
W
Q
Again, using DEBUG, enter the following command.
DEBUG<DR.SCR
You should see the following screen displayed
-N DR.COM
-E 100 E9 86 00 00 52 65 71 75
-E 108 69 72 65 73 20 44 4F 53
-E 110 20 33 2E 30 20 61 6E 64
-E 118 20 75 70 0D 0A 24 00 55
-E 120 73 61 67 65 20 3A 20 52
-E 128 44 20 5B 64 3A 5D 5B 70
-E 130 61 74 68 5D 6F 72 67 6E
-E 138 61 6D 65 20 6E 65 77 6E
-E 140 61 6D 65 0D 0A 24 00 00
-E 148 00 00 20 69 73 20 4E 4F
-E 150 54 20 61 20 64 69 72 65
-E 158 63 74 6F 72 79 0D 0A 24
-E 160 00 00 00 44 69 72 65 63
-E 168 74 6F 72 79 20 4E 4F 54
-E 170 20 66 6F 75 6E 64 20 6F
-E 178 72 20 49 4E 56 41 4C 49
-E 180 44 20 70 61 74 68 0D 0A
-E 188 24 B8 00 30 CD 21 3C 03
-E 190 73 0C BA 0E 01 B4 09 CD
-E 198 21 B8 01 4C CD 21 BE 81
-E 1A0 00 FC E8 5B 00 73 05 BA
-E 1A8 1F 01 EB E9 89 F2 4A E8
-E 1B0 41 00 72 F3 C6 44 FF 00
-E 1B8 89 F3 E8 43 00 72 E8 EE
-E 1C0 FE 4F E8 2E 00 73 06 80
-E 1C8 7C FF 0D 75 DA C6 44 FF
-E 1D0 00 B8 00 43 CD 21 F7 C1
-E 1D8 10 00 75 0D C6 47 FF 24
-E 1E0 B4 09 CD 21 BA 4A 01 EB
-E 1E8 AC B4 56 CD 21 BA 63 01
-E 1F0 72 A3 C3 AC 3C 20 74 06
-E 1F8 3C 0D 75 F7 F9 C3 F8 C3
-E 200 AC 3C 20 74 FB 3C 00 75
-E 208 02 F9 C3 F8 C3 90 90 90
-RCX
CX 0000
:10D
-W
Writing 0010D bytes
-Q
Don't forget, this program you created requires DOS 3.0 and
later. Now that we have this utility, we can start renaming
directories. To use DR.COM you enter a command line similar to
the following :
DR olddir newdir
Where 'olddir' is the current directory name, including drive
and path, 'newdir' is the new name to call it.
EXAMPLE: If you have a directory called BUG and want to rename
it BUGGED, you enter :
DR BUG BUGGED
And, if your directory is D:\FILES\HOPE and you want it to
change HOPE to HOPEFUL, then you'd enter :
DR D:\FILES\HOPE HOPEFUL
(The new path will be "D:\FILES\HOPEFUL")
In this fashion, we can rename a directory, which is NOT on the
current drive.
Tutorial finished. Have you registered PC-Learn to receive your
bonus disks? Registration is encouraged. Shareware works on the
honor system! Send $25 to Seattle Scientific Photography,
Department PCL6, PO Box 1506, Mercer Island, WA 98040. Latest
version of PC-Learn and two bonus disks shipped promptly!